Add Coding Agent Runner community ability by Ju-usc · Pull Request #118 · openhome-dev/abilities

Ju-usc · 2026-02-23T05:40:17Z

Summary

Rename codex-task-runner → coding-agent-runner — works with both Claude Code and Codex
Voice-triggered coding task execution via webhook: ask → confirm → refine prompt → call webhook → speak result
_refine_prompt cleans up STT transcription before sending to the coding agent
_rewrite_for_voice condenses verbose agent output into 1-2 spoken sentences
README shows both agents equally with a unified webhook server example
End-to-end tested via OpenHome + ngrok + Claude Code webhook

Validation

python3 -m py_compile community/coding-agent-runner/main.py
python3 validate_ability.py community/coding-agent-runner

Introduce a WebUI-compatible ability that relays coding tasks to a Codex webhook with confirmation/cancel flow and conversational summaries. Document setup, trigger words, and a minimal Codex-focused /run webhook contract for contributors.

Replace explicit register_capability boilerplate with the template register tag and remove raw open() usage so the ability matches updated validation requirements.

github-actions · 2026-02-23T05:40:25Z

🔀 Branch Merge Check

PR direction: add-codex-task-runner → dev

✅ Passed — add-codex-task-runner → dev is a valid merge direction

github-actions · 2026-02-23T05:40:28Z

✅ Ability Validation Passed

📋 Validating: community/coding-agent-runner
  ✅ All checks passed!

github-actions · 2026-02-23T05:40:29Z

🔍 Lint Results

🔧 Auto-formatted

Some files were automatically cleaned and formatted with autoflake + autopep8 and committed.

✅ Unused imports removed (autoflake)
✅ Unused variables removed (autoflake)
✅ PEP8 formatting applied (autopep8)

✅ `init.py` — Empty as expected

Files linted: community/coding-agent-runner/main.py

✅ Flake8 — Passed

✅ All checks passed!

Copilot

Pull request overview

This PR adds a new community ability called "Codex Task Runner" that enables voice-triggered execution of coding tasks via an external webhook. The ability implements a confirmation flow before executing tasks, provides conversational spoken summaries of results, and uses placeholder-based webhook configuration for easy deployment.

Changes:

New voice-controlled ability for remote Codex task execution with confirmation flow and spoken results
Comprehensive documentation including setup instructions, webhook API contract, and example server implementation
Configuration via inline constants (WEBHOOK_URL, WEBHOOK_TOKEN) for WebUI-friendly setup

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.

File	Description
community/codex-task-runner/main.py	Core ability implementation with conversation flow, webhook calls, and summary generation
community/codex-task-runner/README.md	Setup documentation and example webhook server implementation
community/codex-task-runner/init.py	Empty package initialization file (standard Python package structure)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

community/codex-task-runner/main.py

community/codex-task-runner/README.md

community/codex-task-runner/main.py

community/codex-task-runner/README.md

codermohsin · 2026-02-23T07:24:24Z

Hey
I ran your ability code but it give this error "[ERROR]
1771830995.2642982:Error in ability: github_abilities, Details: GithubAbilitiesCapability.register_capability() missing 1 required positional argument: 'cls'"

"

How to fix:

# Do not change following tag of register capability
#{{register capability}}

Currently you added extra text before the register capability block like this -> "# register capability tag: #{{register capability}}"

 try this  

    #{{register capability}}

def call(self, worker: AgentWorker):
    """OpenHome SDK hook; starts async ability flow."""
    .
    .
   .

- Rename folder, class, log tag, and voice prompts to be agent-agnostic - Add _refine_prompt to clean up STT transcription before sending to agent - README shows Claude Code and Codex equally with unified webhook example - End-to-end tested via OpenHome + ngrok + Claude Code webhook

Ju-usc · 2026-02-23T23:57:31Z

@codermohsin Thanks for catching that! I've refactored the ability and fixed the register tag issue:

Renamed to coding-agent-runner — now works with both Claude Code and Codex (just swap the agent in the webhook server)
Fixed #{{register capability}} tag — it's on its own line now, no extra text
Added _refine_prompt to clean up voice transcription before sending to the agent
End-to-end tested via OpenHome + ngrok + Claude Code webhook

Let me know if anything else breaks.

Copilot

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

community/coding-agent-runner/main.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Juyoung Lee <112113286+Ju-usc@users.noreply.github.com>

Ju-usc added 3 commits February 22, 2026 21:36

Add Codex Task Runner community ability

44e2db8

Introduce a WebUI-compatible ability that relays coding tasks to a Codex webhook with confirmation/cancel flow and conversational summaries. Document setup, trigger words, and a minimal Codex-focused /run webhook contract for contributors.

docs: align webhook example with safe scoped Codex execution

c4df336

fix: align Codex Task Runner with new validator rules

b367543

Replace explicit register_capability boilerplate with the template register tag and remove raw open() usage so the ability matches updated validation requirements.

Copilot AI review requested due to automatic review settings February 23, 2026 05:40

Ju-usc requested a review from a team as a code owner February 23, 2026 05:40

github-actions bot added first-contribution First-time contributor community-ability Community-contributed ability labels Feb 23, 2026

style: auto-format Python files with autoflake + autopep8

9f4007a

Copilot started reviewing on behalf of Ju-usc February 23, 2026 05:40 View session

Ju-usc and others added 2 commits February 22, 2026 21:41

fix: preserve register capability tag format

067a59f

style: auto-format Python files with autoflake + autopep8

fd1d78e

Copilot AI reviewed Feb 23, 2026

View reviewed changes

Ju-usc and others added 5 commits February 22, 2026 22:02

fix: address PR feedback on async webhook and docs hardening

a6125eb

fix: preserve register capability tag format

9a7dff3

style: auto-format Python files with autoflake + autopep8

32590ab

fix: keep validator register tag stable under auto-format

5146102

refactor: simplify Codex Task Runner flow

2796cfd

Ju-usc and others added 2 commits February 23, 2026 15:53

style: auto-format Python files with autoflake + autopep8

44baef9

Ju-usc requested a review from Copilot February 24, 2026 00:11

Copilot started reviewing on behalf of Ju-usc February 24, 2026 00:12 View session

Copilot AI reviewed Feb 24, 2026

View reviewed changes

community/coding-agent-runner/main.py Show resolved Hide resolved

community/coding-agent-runner/main.py Show resolved Hide resolved

Ju-usc changed the title ~~Add Codex Task Runner community ability~~ Add Coding Agent Runner community ability Feb 24, 2026

Ju-usc and others added 2 commits February 23, 2026 16:35

Apply suggestion from @Copilot

ef5872a

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Juyoung Lee <112113286+Ju-usc@users.noreply.github.com>

style: auto-format Python files with autoflake + autopep8

e94e1b7

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Comments

Add Coding Agent Runner community ability#118

Add Coding Agent Runner community ability#118
Ju-usc wants to merge 15 commits intoopenhome-dev:devfrom
Ju-usc:add-codex-task-runner

Ju-usc commented Feb 23, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 23, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 23, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 23, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

codermohsin commented Feb 23, 2026

Uh oh!

Ju-usc commented Feb 23, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Comments

Conversation

Ju-usc commented Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Validation

Uh oh!

github-actions bot commented Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔀 Branch Merge Check

Uh oh!

github-actions bot commented Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Ability Validation Passed

Uh oh!

github-actions bot commented Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔍 Lint Results

🔧 Auto-formatted

✅ __init__.py — Empty as expected

✅ Flake8 — Passed

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

codermohsin commented Feb 23, 2026

Uh oh!

Ju-usc commented Feb 23, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Ju-usc commented Feb 23, 2026 •

edited

Loading

github-actions bot commented Feb 23, 2026 •

edited

Loading

github-actions bot commented Feb 23, 2026 •

edited

Loading

github-actions bot commented Feb 23, 2026 •

edited

Loading

✅ `init.py` — Empty as expected